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The USL NASA PC R&D 
DEVELOPMENT ENVIRONMENT STANDARDS 


ABSTRACT 


To facilitate the development of PC based projects, it is 
necessary to establish a set of operating standards. The intent 
of these procedures is to prevent unintentional interference 
between projects being concurrently developed on the PCs. 


The standards address the following areas : 

Scheduling PC resources 
Login/Logout Procedures 
Tr a i n ing 

File Naming Conventions 
Hard Disk Organization 
Diskette Care 
Backup Procedures 
Copying Policy 


Progranxning standards will be addressed in separate ’PC 
Progranming Standards’ documents. 
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I . SCHEDULING PC RESOURCES 

In order to assure a rational allocation of PC resources, a 
project proposal must be submitted to, evaluated by, and 
scheduled by the PC-R&D Team before any pc-based development work 
is initiated. The proposal should contain an estimate of PC time, 
PC storage, and system software required. The evaluation process 
will assign a priority to the project and schedule (or not 
schedule) it accordingly. A schedule sheet will be posted, 
containing the current PC time reservations. Any unreserved time 
slots can be used for training and experimentation. 


1 1 . LOGIN/LOGOUT 

Once a project is scheduled , all development should be done 
while logged in under that project. The login/logout procedures 
are intended only to allow some measurement of PC resource 
utilization. Each scheduled project will be assigned a project 
name to be used for relevant development; work not pertinent to 
a scheduled project should be performed under the train project. 
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III. TRAINING 

Training materials will be made available for all system 
software in terms of users manuals, comnented working examples, 
online help, and, in some cases, online tutorials. As training 
material becomes available, notices will be distributed via 
Multics mail and through demonstration sessions. Questions 
may be placed in the PC Black Box; questions and answers will be 
posted. 


IV. NAMING CONVENTIONS 

PC DOS 2.1 allows eight character file names with three 
letter extensions. To allow consistent and efficient use of wild 
card file specifications, the following naming conventions should 
be adhe red to: 

1) The first eight characters positions should contain only 

the characters: { ’ a ’ . . ’ z ’ , ’A’ . . ’Z* , ’ 1 * . . ’ 9 ’ , * - * } and should 

comprise a meaningful name. 

2) Extensions should indicate file type or format. The 

recommend extensions are: 

HLP - Help files 

SYS - System log files 

PAS - PASCAL source files 

BAS - BASIC source files (compressed and ascii) 

C - C source files 

RF - Files in the Multics runoff format 
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Files in the Wordix format 
Runof f output 
Wo rdix output 

Unlinked intermediate object code 
Exec u t ab 1 e mach i ne code 

Executable machine code (quick load format) 
ASCII files containing DOS commands 
Assembler source code 

Library files (contain multiple OBJs) 
Printer device drivers 


V. HARD DISK ORGANIZATION 


PC DOS 2.1 supports a hierarchical file system which is a 
valuable storage management feature. The following structure 
policy has been adopted: 


WX 

RO 

WO 

OBJ - 
EXE - 
CCM - 
BAT - 
ASM - 
LIB - 
DVC - 


1) The ROOT directory (\) will contain only other directory 
entries and system startup batch files. 

2) Each registered user will have an individual directory 
under work not appropriate to project d i r e c t or i e s .&D for 

3) The GfrM directory will be used for uploading and 
downloading files. Once the accuracy of the file is 
established, it should be inxnediately copied out of the (^M 
directory to the appropriate area and deleted. 

4) Because access to overlays, libraries, and error files is 
necessary for most compilers, all compilations should be 
done in the appropriate language files removed before users 
1 ogof f . 
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5) For each project, an operational and a developmental 
directory will be established. Code will be migrated from 
the developmental to the operational directory only after it 
has met pre-defined debugging criteria (see C Progranming 
Standards ) 

6) The \DOS directory contains system support files. No files 
should be added to this directory. 

7) All major software systems will be located in dedicated 
directories to facilitate installation and backup. (e.g., 
\DBASE2 , OVM, \WP\EDIX, etc.) 

VI. DISKETTE CARE 

Floppy diskettes, because they are exposed directly to 
environmental conditions, require a certain degree of care to 
mantain their integrity. The following guidelines should prevent 
any difficulties: 

1) Keep diskettes in jackets until they are inserted into 
the disk drive. 

2) If diskettes must be carried out of the lab, keep them in 
a rigid sealed container. Keep diskettes away from heat and 
mo i s t u r e . 

3) Never bend diskettes or touch the mylar surface. Should a 
diskette become contaminated, do not insert it into the 
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diskette drive. To do so would cause contamination of disk 
dr i ve heads . 

4) Never write on diskettes with a ballpoint pen; use felt 
tip markers only . 

5) Always label diskettes, regarding contents and write 
protect critical diskettes by covering the write protect 
notch with a write protect tab. 

VII. BACKUP PROCEDURES 

Project directories will be backed up, via the backup 
comnand, by system personnel at 5pm on Fridays. Users will be 
responsible for backing up any significant changes in the 
interim. All backup diskettes should be clearly labeled, showing 
date of backup, directory path, contents, and sequence number, 
for mu 1 1 i -d i ske 1 1 e backups. 

VIII. COPYING POLICY 

Purchased software may be copied, for backup purposes, 
exclusively by system personnel. Users may not, for any reason, 
copy software purchased for use on the PC/XTs. Illegal 
distribution of software jeopardizes not only the individuals 
involved, but the University and the project as a whole. 
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